multiselection: Convert docs
authorMatthias Clasen <mclasen@redhat.com>
Mon, 1 Mar 2021 06:50:44 +0000 (01:50 -0500)
committerEmmanuele Bassi <ebassi@gnome.org>
Thu, 11 Mar 2021 16:37:37 +0000 (16:37 +0000)
gtk/gtkmultiselection.c

index 70ee6ea8bb4fab010de93526443fe187d0b03df6..2b60ab83020469ef4e19277240094decb58b52e8 100644 (file)
 #include "gtkselectionmodel.h"
 
 /**
- * SECTION:gtkmultiselection
- * @Short_description: A selection model that allows selecting multiple items
- * @Title: GtkMultiSelection
- * @see_also: #GtkSelectionModel
+ * GtkMultiSelection:
  *
- * GtkMultiSelection is an implementation of the #GtkSelectionModel interface
- * that allows selecting multiple elements.
+ * `GtkMultiSelection` is a `GtkSelectionModel` that allows selecting multiple
+ * elements.
  */
 
 struct _GtkMultiSelection
@@ -347,9 +344,9 @@ gtk_multi_selection_class_init (GtkMultiSelectionClass *klass)
   gobject_class->dispose = gtk_multi_selection_dispose;
 
   /**
-   * GtkMultiSelection:model:
+   * GtkMultiSelection:model: (attributes org.gtk.Property.get=gtk_multi_selection_get_model org.gtk.Property.set=gtk_multi_selection_set_model)
    *
-   * The list managed by this selection
+   * The list managed by this selection.
    */
   properties[PROP_MODEL] =
     g_param_spec_object ("model",
@@ -370,12 +367,12 @@ gtk_multi_selection_init (GtkMultiSelection *self)
 
 /**
  * gtk_multi_selection_new:
- * @model: (allow-none) (transfer full): the #GListModel to manage, or %NULL
+ * @model: (allow-none) (transfer full): the `GListModel` to manage, or %NULL
  *
  * Creates a new selection to handle @model.
  *
- * Returns: (transfer full): a new #GtkMultiSelection
- **/
+ * Returns: (transfer full): a new `GtkMultiSelection`
+ */
 GtkMultiSelection *
 gtk_multi_selection_new (GListModel *model)
 {
@@ -394,8 +391,8 @@ gtk_multi_selection_new (GListModel *model)
 }
 
 /**
- * gtk_multi_selection_get_model:
- * @self: a #GtkMultiSelection
+ * gtk_multi_selection_get_model: (attributes org.gtk.Method.get_property=model)
+ * @self: a `GtkMultiSelection`
  *
  * Returns the underlying model of @self.
  *
@@ -410,13 +407,14 @@ gtk_multi_selection_get_model (GtkMultiSelection *self)
 }
 
 /**
- * gtk_multi_selection_set_model:
- * @self: a #GtkMultiSelection
- * @model: (allow-none): A #GListModel to wrap
+ * gtk_multi_selection_set_model: (attributes org.gtk.Method.set_property=model)
+ * @self: a `GtkMultiSelection`
+ * @model: (allow-none): A `GListModel` to wrap
+ *
+ * Sets the model that @self should wrap.
  *
- * Sets the model that @self should wrap. If @model is %NULL, @self
- * will be empty.
- **/
+ * If @model is %NULL, @self will be empty.
+ */
 void
 gtk_multi_selection_set_model (GtkMultiSelection *self,
                                GListModel        *model)